home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / UTIL / SCREEN / LIFEGUARD / !Lifeguard / Documents / !ReadMe next >
Text File  |  1992-11-09  |  10KB  |  208 lines
  1. Lifeguard 1.14 (10-Oct-1992)
  2. ============================
  3.  
  4. © Jon Ribbens, 1992
  5.  
  6.  
  7. PLEASE READ THE 'Licence' FILE IN THIS DIRECTORY - THIS PROGRAM IS SHAREWARE
  8.                                                                    ---------
  9.  
  10. This is an unregistered copy - it has certain limitations which are not
  11. present in the registered version.
  12.  
  13. If you carry on using this program after fourteen days then you are required
  14. to register - see below under 'Notes about registering'.
  15.  
  16.  
  17. Introduction
  18. ------------
  19.  
  20.    This program is, basically, a 'monitor saver'. As everybody knows, if
  21. you leave a still image on your monitor screen for a long time then it
  22. will eventually get 'burnt in' to the phosphor and will stay there, faintly,
  23. forever. This is obviously a bit of a waste of your extortionately priced
  24. monitor. Therefore, if the monitor saver detects that you haven't used the
  25. mouse or the keyboard for a set period of time (anything between 1 second and
  26. a bit over 1½ hours) then it will blank the screen. To unblank the screen you
  27. press a key or click a mouse button.
  28.    What is slightly special about this monitor saver is that instead of
  29. just blanking (ie. turning black) the screen (although it can do this if
  30. you really want it to) it can display any one of several interesting and
  31. psychologically stimulating graphic effects. For example, your screen could
  32. turn into a fireworks display, it could fade away slowly, it could bounce a
  33. sprite around, it could display a clock - almost anything is possible.
  34.    What is very special about this monitor saver (on the Archimedes anyway)
  35. is that it is designed to be easily extendable to include other effects. New
  36. effects come as small files that you drag to the iconbar icon or the setup
  37. window and are automatically included in the program.
  38.    You can write your own effects (if you can program in assembler) or you
  39. can get effects written by me or other people and, if you like them, you can
  40. include them in your effects library.
  41.  
  42.  
  43. Installing Lifeguard
  44. --------------------
  45.  
  46.   Lifeguard uses my WimpExtension module for several things. This is assumed
  47. to be in your !System.Modules directory. If it isn't, move the file 'WimpExt'
  48. from inside the !Lifeguard directory to the !System.Modules directory.
  49.   WimpExtension is a PD module which does useful things for making programs
  50. in the desktop look nicer and easier to write. It provides facilities for
  51. options window handling, for dialogue boxes, for controlling indirected
  52. icons, for loading templates, for colour menus, for RAM templates, for
  53. dragging icons, for menu handling, for draw-files and sprites, for immediate
  54. windows, for memory management, for file transfer, etc., etc.
  55.  
  56.  
  57.  
  58. Using Lifeguard
  59. ---------------
  60.  
  61.    Once it's loaded you should see a ring thingy appear on your icon bar.
  62. If you click on it with the menu button then you get a menu with the options
  63. 'Info =>', 'Setup', and 'Quit'. 'Info' leads to a normal info window, and
  64. quit quits. 'Setup' has the same effect as clicking on the icon with the
  65. select button, and it opens the setup window.
  66.    Looking at this window from the top down, the first thing there is is the
  67. time delay setup area. The number on the left is the minutes, the number on
  68. the right is the seconds. Use the up and down arrows to change them.
  69.    Then there is a radio button to enable the monitor saver, and for the
  70. password. The password is initially set to '' - ie. just press RETURN. To
  71. alter the password, click on the 'Alter password' icon. You will be asked for
  72. the old password, then you will be allowed to change it for a new one. If you
  73. enable the password option, then when you try to un-blank the screen after it
  74. has blanked you will have to enter the password. This provides a very easy to
  75. use security system - just leave it and forget about it.
  76.    The next area is the effects list. It is like a window within the window,
  77. in that you can scroll it up and down using the scroll-bar to the right of
  78. it. You can select an effect by clicking the select button on it. You can
  79. select several effects at once by using the Adjust button (like filer
  80. windows). Effects that have a tick before them are enabled. When the screen
  81. is blanked, the effect to use is chosen randomly from the list of enabled
  82. effects.
  83.    To the right of the effects list are two boxes which, when you have one
  84. effect only selected, display the version number of the effect, a short
  85. description, and the author's name.
  86.    To enable, disable, display or remove an effect, select it and then press
  87. the menu button. Follow the 'Effect =>' option to its submenu. 'Enable' or
  88. 'Disable' enable or disable the effect. When the screen is blanked, the
  89. effect is chosen randomly from the enabled effects.
  90.    'Display' shows the effect immediately, so you can see what it looks
  91. like. You can also see the effect by double-clicking on its name in the list.
  92. 'Remove' deletes the effect permanently. This saves on memory, but you can't
  93. get the effect back unless you have the original effect module file.
  94. 'Options' brings up the effect's Options window if it's got one.
  95.    'Dim' means that effects like 'Puzzle' will have the screen faded to half
  96. brightness beforehand. Note that this doesn't work in 256 colour modes.
  97.    'No blanking' disables the interrupt blanking done by the Guard module.
  98. (See below)
  99.    Selecting 'Save setup' from the first menu will save the entire setup,
  100. including the effects, the password, the time delay, and whether the monitor
  101. saver is enabled or not.
  102.    If 'Always fade' is on then Lifeguard will always choose an effect that
  103. needs the desktop screen first. This has the effect that effects that don't
  104. use the desktop screen will always be faded into. (They won't ever happen if
  105. you don't have a fade effect installed, though.)
  106.    If Lifeguard reports an error, if there is only an OK box then the error
  107. is just informational, for example if Lifeguard couldn't blank the screen
  108. because there were no effects enabled. If there is a CANCEL box as well, then
  109. it is an unexpected error - click on OK to cancel whatever operation caused
  110. the error and continue, or click on CANCEL to quit Lifeguard altogether.
  111.  
  112.  
  113. Effects
  114. -------
  115.  
  116.    To add other effects when you have them as separate files, just drag them
  117. onto the iconbar icon or into the setup window, or double-click them. They
  118. will be added onto the end of the effects list. Remember that you need to
  119. enable them before they will be used. You can have up to 64 effects loaded at
  120. once.
  121.    The 'Black' effect is the simplest effect possible - it just turns the
  122. screen black. More complicated effects are more interesting, such as
  123. 'Fireworks'. See the file 'Effects' in the documents directory for a list of
  124. all the supplied effects.
  125.    You can also write your own effects if you can program in assembler. See
  126. the accompanying file 'FileSpec' for details.
  127.  
  128.  
  129. Effects Options
  130. ---------------
  131.  
  132.    Individual effects can have options windows. If an effect has an options
  133. window it may be opened by double-clicking ADJUST on it in the list window,
  134. or by selected 'Options' from the effects sub-menu. You can only have one
  135. options window open at once. The window should have 'Cancel' and 'OK' buttons
  136. at the bottom. 'Cancel' will close the window and forget any changes you have
  137. made. 'OK' will close it and store the changes. These can be saved to disc by
  138. using the 'Save setup' menu option.
  139.  
  140.  
  141. Using 'Bounce' (note this is not supplied with the unregistered version)
  142. --------------
  143.  
  144.    Bounce can be found in the !Lifeguard.Zource.Effects directory.
  145.    Bounce is a BASIC/assembler program that will create an effect file out
  146. of a sprite file you give it. Simply provide it with the filename of a sprite
  147. file containing one sprite only, and it will save an effects file in the
  148. current directory, with the name of the sprite as the filename.
  149.    The action of the effects module will be to bounce the sprite around the
  150. screen. You can use Bounce for company logos, pictures, scanned images, or
  151. anything else in sprite format (!Paint). Note that the current version of
  152. Bounce requires a 4 OS-Unit black border around the sprite - use !Paint to
  153. put this in if there isn't one already.
  154.  
  155.  
  156. GuardRM
  157. -------
  158.  
  159.    This program is actually two monitor savers in one. There is the desktop
  160. Lifeguard program which will display pretty effects, and the Guard
  161. relocatable module. This is always loaded with Lifeguard, and it is this
  162. module which checks for keypresses and mouse clicks. It also will blank the
  163. screen about ten seconds after Lifeguard SHOULD have blanked it, if Lifeguard
  164. doesn't blank it. This means that if you are outside the desktop, or if
  165. another application crashes while you are in the desktop, the screen will
  166. still be blanked, saving your monitor (but with no pretty effects).
  167.    Lifeguard won't work without GuardRM loaded (it is loaded automaticaly
  168. when you load Lifeguard) but GuardRM will work as a simple screen saver
  169. without Lifeguard loaded. Use *Blank <ON|OFF> to turn the blanking on or off,
  170. and *BlankDelay <seconds> to set the time delay before blanking. These
  171. commands will produce errors if Lifeguard is running, as then the enabled
  172. state and the delay are set by the icons in the setup window.
  173.    When you quit Lifeguard, you are given the option to disable GuardRM, or
  174. to kill it (or to leave it alone).
  175.  
  176.  
  177. Notes about registering
  178. -----------------------
  179.  
  180.   This copy of Lifeguard is unregistered; you get an annoying beeping window
  181. at the beginning and you can only have three effects loaded at once. If you
  182. register your copy then you can have up to sixty-four effects at once (and
  183. you don't get the annoying beepy window). You may also receive more effects,
  184. and you will also receive the source code for the rest of the supplied
  185. effects.
  186.  
  187. NB  You are required to register if you keep using Lifeguard fourteen days
  188. --  after you receive it.
  189.  
  190.   If you wish to register, simply send of £10 to the address below with an
  191. accompanying letter, or print out the form in the file 'RegForm', fill it in
  192. and send it with £10 to the address below.
  193.   Site licences are available on request.
  194.  
  195.  
  196.  
  197.    If you wish to write your own effects, see the file 'FileSpec' in this
  198. directory.
  199.  
  200.  
  201. Any queries, bug reports, complaints, money, ideas, whatever, to:
  202.  
  203.                 Jon Ribbens
  204.                 39 Nutkins Way
  205.                 Chesham
  206.                 Bucks.
  207.                 HP5 2BE
  208.